home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / gfx / board / picdrag.lha / picdrag.doc < prev    next >
Text File  |  1994-11-01  |  4KB  |  110 lines

  1.  
  2.                        PicDrag v1.1
  3.  
  4.              Copyright © 1994 Roberto Ferorelli
  5.                         Shareware
  6.  
  7. DESCRIPTION
  8.  
  9. PicDrag  it's  a  commodity that permits to move the windows, dragging not
  10. only the border of the windows but also their contents.
  11.  
  12. It works only with the Picasso II board with Monitor driver in CHUNKY mode
  13. (version 2.45 or greater), vilintuisup.library(version 2.8 or greater) and
  14. obviously OS 2.04+.
  15.  
  16. The  program is quite "dirty" (I should not take it as an example of Amiga
  17. style programming) so I have created different "check controls" that avoid
  18. the  "PicDragging"  when  the conditions are not perfectly safe or are too
  19. difficult to manage (remember, it's simply a trick program).
  20.  
  21. The windows will be "Picdragged" only if:
  22.  
  23. 1) They are on a PICASSO screen with more than 16 colours.  I was unable to
  24. use  screens with fewer colours because the PICASSO driver uses, for these
  25. screens,  a  normal PLANAR mode.  It works also on custom screens promoted
  26. to a picasso mode.
  27.  
  28. 2) They  are  on  the frontmost screen, it doesn't matter if the screen is
  29. moved from the origin.
  30.  
  31. 3) They  have  a normal dragbar.  Picdrag needs to understand where is the
  32. dragbar of the window.
  33.  
  34. 4)  On  the  board  there  is  enough  memory to contain the entire window
  35. together with the screen already buffered on it.
  36.  
  37. If  some  of  the previous condition is not verified Picdrag uses a normal
  38. dragging method.
  39.  
  40. Because  VillageTronic  didn't  release informations on how to program the
  41. internal  blitter  without  using  the vilintuisup.library and neither the
  42. library  itself  permits  to use blitter on Intuitioned-picasso screens, I
  43. had  to  make some trick to confuse the vilintuisup, so it's possible some
  44. compatibility problem.
  45.  
  46. A  timeout  is  present to avoid Intuition locking during window dragging.
  47. The timeout is customizable via tooltypes or via GUI.
  48.  
  49. The program was fully tested, for different months, on a A4000/040 with OS
  50. 3.0.
  51.  
  52. The  program  searches  for the Picasso board in the ConfigDev list, using
  53. the  Productor  Code(2167)  and  the  Product  Code(11), to find the video
  54. memory.   Maybe  your  board  has  different  codes, in that case, you can
  55. change  those  codes  through  two tooltypes.  You only have to read, with
  56. programs like AIBB or SysInfo, the codes of your board and insert these in
  57. the tooltypes.
  58.  
  59. The  options  of  Picdrag can be changed through tooltypes or via GUI (the
  60. hotkey for the option window is <CONTROL SHIFT p>).
  61.  
  62. USAGE
  63. You  run Picdrag simply by clicking twice on its icon.  A second run makes
  64. the  program  exit.  If you want Picdrag always active, you have to insert
  65. its  icon  in  the  WBStartup  drawer  of Workbench(remember the DONOTWAIT
  66. tooltype)
  67.  
  68. The tooltypes are:
  69.  MANUFACTURER=<Number>  (default:2167)
  70.  PRODUCT=<Number>)      (default:11)
  71.    With these you can specify the Productor Code or the Product Code of
  72.    your picasso board.
  73.  
  74.  TICKS=<Number 1-3>
  75.    The number(between 1 and 3) is the resolution of the dragging process.
  76.    I  need  that  because  during  Picdragging the mouse accelerator don't
  77.    work.
  78.  
  79.  TIMEOUT=<Number 1-15>
  80.    It's  the  timeout period.  After that time, if the mouse is not moved,
  81.    the dragging is aborted.
  82.  
  83.  DORECT=<YES or NO>
  84.    If active it draws around the window an inverted rectangle.
  85.  
  86.  CONTINUOUS=<YES or NO>
  87.    If active, a window moved beyond the border of its screen will appear
  88.    on the other side of the same screen.
  89.  
  90.  
  91. --------------------------------------------------------------------------
  92.                               ATTENTION
  93. --------------------------------------------------------------------------
  94.  
  95. I  assume  no  responsability for any damages derived from the use of this
  96. program.   I tested Picdrag on A4000/040 and found no bugs, but there's no
  97. code  without  at  least  a  bug,  so use it but at YOUR OWN RISK!
  98.  
  99. If you have some idea for the program or if you have found a bug(or if you
  100. want simply to make me a gift ;-)), you can contact me:
  101.  
  102. by mail
  103. Roberto Ferorelli
  104. Via Amendola 201/9
  105. 70126 BARI (ITALY)
  106.  
  107. or by email
  108. mc2068@mclink.it
  109.  
  110.